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SWTPC SWTBUG® (SWATBUG) MONITOR ROM 

One of the features of the SWTPC 6800 Computer System is that the conventional 
programmer's console has been replaced with a monitor ROM. The programmer's console 
consists of all the pretty switches and lights often found on similar microcomputers that are 
used to bootstrap the system after power up. The programmer's console not only raises the 
cost of the system, but more often than not is confusing and tedious to use for both be¬ 
ginning and experienced programmers. The monitor ROM on the other hand is a permanent¬ 
ly stored program that gives the computer the intelligence required to communicate with 
the operator thru an interfaced terminal system immediately after power up without flip¬ 
ping switches for 10 minutes. This technique makes the computer do the work of simplify¬ 
ing communication between itself and the operator. 

SWTBUG® is the name of the monitor program used in the SWTPC 6800 Computer 
System. It might be thought of as kind of a mini-operating system since it gives the operator 
command control over the computer system. 

Features of the SWTBUG®ROM include: 

* Memory Examine and Change 

* Program loading from cassette or paper tape thru the control interface or thru 
I/O port # 0. 

* Program saving to cassette or paper tape 

* Go to user program 

* Display contents of registers 

* Erase SWTPC CT-1024 terminal system screen 

* SWTPC MF-68 floppy disk boot 

* Byte search 

* Breakpoint debugging 

* Vectored hardware and software interrupts to user defined addresses 
SWTBUG® is a permanently stored program and cannot be erased or lost by either a 

loss of power or user program error. It is always resident in the computer while power is ON 
and need never be loaded into the machine. Subroutines within the ROM are documented 
and available to the user to simplify programming and^conserve on the use of user RAM 
memory. Character Input and output, string output and return to monitor are just a few 
subroutines available to the user. , f ^ ^ : ^ 

-SWTBUG* is a 1K byte program and is addressed high in memory, far above the 
amount of RAM memory required for most user programs. Since SWTBUG® does require 
a small amount of RAM memory for bperation, a 128 byte i^ratchpad RAM has been im¬ 
plemented on the processor board so that no external user RAM memory is required for 
monitor operation. There is even enough ^tra room in this RAM so that short programs 
such as memory diagnostics can be loaded into and run from the scratchpad RAM without 
requiring any external user RAM memory. Extra care however must be exercised to avoid 
overstoring any memory locations required for proper monitor operation. Complete de¬ 
tails on this are given later in this writeup. The SWTBUG® ROM is located from memory 
addresses E000 thru E3FF. The scratchpad RAM is located from memory addresses A000 
thru A07F. Both components are physically located on the processor board and are func¬ 
tional any time the system is powered up. Whenever computer control Is transfered from 
SWTBUG® to the user program, there are only four ways to get back into the SWTBUG® 
command mode. The first is to put a jump to the CONTRL entry point address within 
SWTBUG® as the last step of your program. The second is to incorporate a command or 
action within your program which transfers program control to the CONTRL entry point 
address within SWTBUG*. The third is to depress the front panel RESET button. The 
fourth is turn the computer OFF and then back ON again. The fourth method is rather 
drastic and wipes out all RAM memory data, it is only mentioned to let you know that the 
computer always powers up with the SWTBUG® monitor in the command mode. 
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SWTBUG* INSTALLATION 

SWTBUG* is a MOS device and MOS integrated circuits are susceptable to damage by 
static electricity. Although some degree of protection is provided internally within the in¬ 
tegrated circuits, their cost demands the utmost in care. Before opening and/or installing 
SWTBUG* you should ground your body and all metallic tools coming into^^tact with the 
leads, thru a 1M ohm % watt resistor. The ground must be an "earth" ground such as a 
water pipe, and not the circuit board ground. As for connection to your body, attach a clip 
lead to your watch or metal ID bracelet. Make absolutely sure that you have the resistor 
connected between you and the "earth" ground, otherwise you will be creating a dangerous 
shock hazard. Avoid touching the leads of the integrated circuits any more than necessary 
when installing it, even if you are grounded. Static electricity should be an important con¬ 
sideration in cold, dry environments. It is less of a problem when it is warm and humid. 

When using SWTBUG* with an MP-A processor card, one board change is necessary 
since SWTBUG® is a full IK ROM and MIKB.UG®was a y 2 K device. If this ROM is replacing 
MIKBUG*. remove MIKBUG® from its socket. On the back side of the MP-A board you 
will notice that pin 15 of IC-2 (ROM) is grounded. The land coming from pin 15 should be 
broken and a wire added as shown below. 


MP-A PROCESSOR BOARD 

BOTTOM 

CUT THE TRACE CURRENTLY 
GOING TO PIN 15 

ADD THIS JUMPER-^ 






The SWTBUG" 




SWTBUG* should now be installed in the socket for IC-2. Be sure to orient the ROM cor¬ 
rectly when re-installing. The semicircle notch or dot should match with the MP-A board's 
component layout drawing. ^ ‘ . ' 

When installing SWTBUG* In the MP-A2 processor board no board modificationsjare 
necessary. Follow the instructions supplied with the MP-A2 instruction set.'. 

^ SWTBUG OPERATION 

a* firmware enables the computer to communicate with a terminal to per¬ 
form various programming and debugging functions. SWTBUG*will communicate with a ter¬ 
minal via either a MP-C control Interface or MP-S ACIA serial interface on I/O port 1. An 
optional MP-C interface can be installed on I/O port 0 for punch and load functions. Al¬ 
though SWTBUG*is essentially compatible with MIKBUG ®, be sure to read the COMPATI¬ 
BILITY section before running any programs written for MIKBUG*. Below is a detailed 
description of each SWTBUG®command. 



RESET 

Upon receiving a RESET command, as during power up, SWTBUG® will initialize the 
system to receive commands from a terminal. When the RESET button is pushed, control 
will transfer to location E0D0 of SWTBUG®. The RESET button should be used for exiting 
loops or malfunctioning programs. After resetting, the computer should respond with a car¬ 
riage return, line feed and a $ sign. At this point, SWTBUG® is waiting for commands. If 
breakpoints are being used, the RESET function will not disable breakpoints. The BREAK¬ 
POINT function should be referenced for additional information. 
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MEMORY EXAMINE AND CHANGE M (addr) 

The Memory Examine and Change function can be used to enter machine code pro¬ 
grams and to display and/or change the contents of memory. The Memory Examine and 
Change function should be used as follows: 

1. ) Type M. The computer should echo the M and output a space. 

2. ) Type in the four digit hexadecimal address that you wish to examine and/or 

change. The computer should respond with a carriage return, line feed, $, the 
address and the data that is stored at this address. 

3. ) At this point the user has the option of advancing, either forward or backward, to 

the next memory location, or changing the data stored at the displayed address 
and advancing to the next location or of exiting the M function. 

a. ) To display the next sequential address and data, a line feed or any character 

other than 0123456789ABCDEF : ;t = >? or a space or a carriage return may 
be entered. Any leading spaces that are entered will be ignored by the 
memory change function. 

b. ) To display the next sequential address going backward from the present loca¬ 

tion, a T should be entered. 

c. ) To change the data stored at the displayed location, enter the new data, 

either with or without a leading space. If a non-hex value, such as a 3Q is en¬ 
tered the data will remain unchanged and the memory change function will be 
exited. If the data is unable to be changed (write protected memory, etc.) a ? 
will be output and the memory change function will be exited. 

d. ) To exit the Memory Examine and Change function, type a carriage return. 

Below is an example. The underlined parts are what was entered by the user. 

MFMDPY I nCRTION 0100 DPENED 
niSPLFlY NEXT LOCRTION 

DISPLRY NEXT LOCATION - SPACES IGNORED 
DISPLAY NEXT LOCATION 
CHANGE CONTENTS TO 01 

CHANGE CONTENTS TO 23. SPACES IGNORED 
READ PREVIOUS LOCAtlON-l-^ 

DISPLAY NEXT LOCATION 
ENTER NON-HEX VALUEil#^ ' : 

SWTELIG CONTROL RESUMED 1'OPEN NEI...I LOCATION 
EXIT BY HITTING CARRIAGE RETURN 
OPEN ANOTHER LOCATION 'L 

ATTEMPTED TO CHANGE WRITE PROTECTED MEMORY 
SWTELIG CONTROL RESUMED 

REGISTER DUMP FUNCTION R 

^ The R command will display the current contents of the MPU's pushdown stack. "Cur¬ 
rent" means the status of data stored on the stack immediately before SWTBUG®control is 
resumed. The following is a typical register dump: 



01 

0 0 


SOI 

00 

00 


SOI 

01 

ED 


SOI 

02 

5D 


SOI 

03 

Cl 

O*! 

SOI 

04 

C9 

23 

SOI 

05 

15 


SOI 

04 

23 

T" 

SOI 

05 

15 

30 ' 

SM 

011 



SOI 

05 

15 


SM , 

EOOO^ 


SEOOO 

FF 

56' 


$ 


SR 

SFF 16 23 17 
S 


FC 0103 A 042 

■ L 


rl'sV 


CONDITION CODES ACC B 


ACC A INDEX REG. 
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PGM. CTR. 


STACK PTR. 















The condition codes are as defined below: 


BIT NO. 

0 

1 

2 

3 

4 

5 


LABEL 

C 
V 
' Z 
N 
I 

H 


CONDITION CODE 

Carry—borrow 
Overflow 
Zero 
Negative 
Interrupt mask 
Half carry 


In the above example the condition code of "3C'' can be interpreted as follows: 


3Ci0 — 


1 


BIT 7 


0 

BIT 6 


1 


BITS 


I 

i ^ 

BIT 4 X 
BITS 


1 


BIT 2 


0 0 


1 1 

BIT1 BITO 


Below are two examples of how the R command works. Assume that this small pro 
gram was entered to change certain registers. 


SM 0100 


3:01 00 

CE 

8E 

LORDS 

STRCK POINTER TO 1000 


SOI 01 

12 

1 0 




SOI 02 

34 

0 0 




SOI 03 

86 

CE 

LORD 

INDEX REGISTER MITH 12: 

34 

SOI 04 

00 

12 




SOI 05 

i::6 

34 




SOI 06 

FF 

86 

LORD 

RCCUMULPTOR R MITH 00 


SOI 07 

ED 

00 

■ 

■' ..'.'j-D/. ' 


, SOI 08 

08 

C6 

LORD 

RCCUMULPTOR E MITH FF 


: , 'S0109 

23 

FF 

f*:.' . 



, ^ SOI OR 

67 

7E 

-JUMP 

ERCK TO SMTEUG CONTROL 

■ ■■ - ■ 


. SOI OB 

F7 

EO 




; SOIOC 

60 

E3 





SOIOD HD 

PT THIS POINT THE STPTUS MILL NOT EE PUSHED ON THE STOCK 


- 4 - 







}:R 


:I;FF 

3;G 

DC 

FC 

GEFD 

01 

0 n 

fi04? 

3;R 

SFF 

DC 

FC 

6EFD 

01 

00 

fi04c' 

S;J 

0100 





3iR 







:I:FF 

DC 

FC 

GEFD 

01 

0 0 

fi04£ 

1;M 

01 Ofi 





3:01 

Ofi 7 

E 

3F 




3; 01 

•I' i*Z 

OB E 

n 





3;F9 

•I-O 

FF 

0 0 

1 L=’34 

01 

OR 

0FF9 

i.K 

3;F9 

•I 

FF 

00 

1 £34 

01 

OR 

OFF 9 

•I' 

3;FF 

DC 

FC 

GEFD 

01 

0 0 

fi 04£ 


REGISTER DUMP BEFORE RUNHIMG PROGRfiM 

MOTE P DUMP THE SfiME BFTER RUMNING 

THE SfiME fiFTER fi JUMP 

FIT THIS POINT THE JUMP TO SI..JTEUG CONTROL 
IS REPLfiCED WITH fi SWI. NOTE THE VfiLUE 
OF THE REGISTERS fiFTER THE NEXT DUMP. 

R DUMP GIVEN BY SWI 

DUMP SHOI..tS THE PRDGRfiM CHfiNGES 

R DUMP fiFTER fi RESET 


In the above program you will notice that the register dump after running the program 
is the same as before even though the program contained statements that changed the pro¬ 
cessor's registers. The register dump did not reflect these changes because the new condi¬ 
tions were not pushed on the computer's stack. Note, however, the register dump did re¬ 
flect the change when the last instruction was a software interrupt-a SWI instruction will 
push the processor's status on the stack and then display the contents of the registers. 


CT-1024 CLEAR SCREEN COMMAND C 

The C command outputs a home-up (10i6) and an erase to end of frame (16i6) con¬ 
trol characters for the clearing of the screen on a SWTPC CT-1024 or equivalent terminal 
system. 

GO TO USER'S PROGRAM FUNCTION G ^ 

Upon entering a G command, SWTBUG will transfer control to the user's program by 
executing a RTI (return from interrupt) instruction. This effectively causes the computer to 
jump to the memory address stored in memory locations A(^48 and A049 in the SWTBUG® 
RAM. A(J48 contains the most significant byte and A049 the least significant byte of the 
memory address. If, for example, you wish to execute a program starting at 010(?, change 
A048 to a 01 using the M function and change A049 to 00. Typing a G will then cause the 
computer to execute the program whose starting address is 0100. Upon entering a program 
using the G function, the stack pointer will be set at A049. The G function is also used to 
restart a program after a breakpoint has been moved. In this case A048 and A049 should 
not be changed. See the Breakpoint section for further information. 

JUMP TO USER'S PROGRAM J(addr) 

The J command will cause the computer to execute the program whose starting address 
is given in the entered address. The J command does not look at locations A048 and A049. 
The stack pointer will be set at A042 upon entering a program with a jump command. Ex¬ 
ample: J 0100. If a non-hex character is entered, SWTBUG® control will resume. 

ASCII TAPE PUNCH COMMAND P 

The P command provides a means for storing the contents of specified memory on 
either cassette or paper tape. Normal output from the computer during a punch is thru 
either an MP-C or MP-S serial interface on I/O port 1, but a MP-C interface on I/O 0 can be 
selected. (See the description of the O command.) To use the P command, the upper and 
lower limits of the range to be punched must first be stored in locations A002-A005 of the 



( 
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SWTBUG* RAM. If you wanted to punch from addresses 0123 to 4567 (inclusive) you 
would use the memory examine and change functions to set computer memory as follows. 

A002->01 MOST SIGNIFICANT BYTE OF LOWER ADDRESS 

A003->23 LEAST SIGNIFICANT BYTE OF LOWER ADDRESS 

A004->45 MOST SIGNIFICANT BYTE OF UPPER ADDRESS 

A005->67 LEAST SIGNIFICANT BYTE OF LOWER ADDRESS 

Typing P would turn the punch on and output the specified memory data. A sample 
punch output is as follows: 


3:M fi002 
1:8002 02 

01 

MSB OF LOW ADDRESS 

1:8003 

72 

0 0 

LSBOF LOW ADDRESS 

$8004 

EF 

01 

MSB OF HIGH ADDRESS 

$8005 

00 

20 

LSB OF LOW ADDRESS 

$8006 

$P 

5F 


TAPE PUNCH COMMAND 


S113 01 0 08E100 OCF123486 0 0C6FF3FE 0E3riri 0 OSDBE 
S113 011 08 09 OE 0516 0F73fi82 01F5 0 0FFC;79771H1F2 
SI 04012000riR 
$ 

S113 01 0 08E1 0 0 OCE12346A 0 0i::6FF3FE 0E3riD 0 05DE2 


BYTE COUNT BLOCK STARTING DATA CHECKSUM 

BLOCK CHARACTER (HEX) ADDRESS 

The SI at the start of the block is used to tell the load routine that valid punch data 
follows. Each punch block must begin with the SI. The 13i6 is the number of bytes that 
follow in the block. In this case two bytes are required for the starting address of the block 
(01 and 00), 1016 bytes are required for the data (8E10 (JO CE 12 34 86 00 C6 FF 3F E0 
E3 DD 00 50) and one byte is required for the checksum (B2). The checksum is generated 
by adding the complement of the start of block address and the data, 8 bits at a time. At 
load-in time another checksum is generated by the load routine which must match with the 
one generated at punch time. 

As the punch begins a PUNCH ON (12i6) control character will be output to the 
punch device. If a MP-C control interface is the selected interface, un-used lines on the PIA 
will be strobed to turn on the punch function of a SWTPC AC-30 or equivalent tape inter¬ 
face. (See the PIA Strobing section for more information.) When the punch is completed, a 
PUNCH OFF (14 i 6) control character will be output and another PIA line will be strobed. 
User control is then returned to SWTBUG®. To complete the tape making procedure you 
will have to enter the end of tape command described below. 


END OF TAPE COMMAND E 

The E command will punch the contents of the program counter (A048-A049) and an 
S9 to tape. The S9 is decoded by the load routine as an "end of tape" marker. For example, 
if you wish to save a program that resides from 0000 to 000F and whose starting address is 
0005, you would perform the following sequence- 


$M 8002 
$8002 FC 

00 

$8003 

3E 

00 

$8004 

80 

00 

$8005 

49 

OF 

$8006 

4C 





START OF 
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J.M fi048 
3ifl048 01 00 

3;fi049 03 05 

3;ft04fi F4 
SP 

S113 0 0 0 0 OR 05 010 01EF 083FF 01R 01E351B37 088443 
SE 

S105R 048 0 0 05 ODSS 
$ 

* 


A048 and A049 are automatically transferred to A002-A005 and punched to tape by 
the E command. A short delay follows the S9 to allow clean load-ins on cassette tape. Ap¬ 
propriate punch on/off commands are automatically sent. 

TAPE LOADER FUNCTION L 

The L function is used to load either a MIKBUG® or SWTBUG formatted program 
from either paper or cassette tape. To use the L function, first set up the tape in the loading 
device and type L. As with the punch command, a L function will load from an MP-S or MP- 
C on I/O port 1 or if selected a MP-C on I/O port 0. A READER ON (1116) control charac¬ 
ter is output at the beginning of the load and terminal echo is disabled. Again the PIA is 
strobed for use with a tape interface. When the S9 end of tape marker is read, control will 
return to SWTBUG® . If a checksum error is detected, a ? will be printed and control will re¬ 
turn to SWTBUG®. The load routine verifies that the data being loaded is actually stored in 
the correct memory locations. If, for some reason, a byte is not stored {bad memory, etc.) 
the computer will respond with a ?. To abort the load function the RESET switch can be 
pressed. Before attempting to load a SWTPC binary formatted tape, be sure to read the 
COMPATIBILITY section. 


OPTIONAL PORT COMMAND O (not zero) 

The O (not zero) command enables the user to load from or punch to a MP-C control 
interface plugged on to port 0. To use the O command, type O followed by the desired op¬ 
tion P, E or L (punch, end of tape or load). The same rules apply for using the P, E and L 
functions as described earlier. The O command will not support an ACIA type serial inter¬ 
face on port 0. 

NOTE: When using a MP-C interface on port 0, a RESET will not, automatically turn 
off the reader and punch as is done when installed on port 1. This makes it impossible to 
create or load a binary formatted tape from an MP-C interface installed on I/O port 0 using 
existing binary load and punch programs. -■ f < 


SOFTWARE BREAKPOINTS B(addr) 



The B command enables the user to enter breakpoints (software interrupts) in a pro¬ 
gram for debugging purposes. Breakpoints enable a program to be stopped at any point for 
register examination, memory changing, etc. 

To use the breakpoint function, first load in your program and set up A048 and A049 
to the starting address of the program. Type B and then enter the address where you want 
to set the first breakpoint. SWTBUG®will store the data that was at this address and replace 
it with a 3F (software interrupt). Typing G for Go to User Program will start program exe¬ 
cution. When the program reaches the 3F, execution will stop and the processor's registers 
will be displayed. The B function can be used again to move the breakpoint to a new loca¬ 
tion—SWTBUG® automatically replaces the data at the old breakpoint location with the ori¬ 
ginal instruction. A G should be used to re-start the program—do not reset A048 and A049— 
SWTBUG*automatically pulls the restart location from the stack. To remove breakpoints, 
type B followed by a carriage return. Breakpoints should always be removed in this way 
after using the breakpoint function. If, while using breakpoints, the system is reset, the cor¬ 
rect location on the stack will be lost. After resetting, the program counter addresses (A048, 
A049) should be re-initialized to the beginning of the program and execution restarted. A 
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previously set breakpoint will remain and may be changed or removed as described earlier. 
If, when using the B command, a non-hex value is entered the previous breakpoint will be 
removed and SWTBUG®control will resume. 

There are several things that one must be aware of when using breakpoints to insure 
proper operation. 

1. ) The breakpoint function uses the same locations as do vectored software inter¬ 

rupts, therefore, vectored software interrupts should not be used with break¬ 
points. 

2. ) The SWI jump location, A012, will be set to El24 when breakpoints are not in 

use, as after power up, and will be set to El23 when breakpoints are in use. This 
location serves as a pointer to tell the computer what to do when a 3F is seen.The 
reset button will not re-set this location to the non-breakpoint state. The 
breakpoint-activated state can only be exited by typing B followed by a carriage 
return. If you are using breakpoints in a program that "bombs out" and you hit 
the RESET switch, you must clear the present breakpoint before going on to 
another program. If this is not done before a new program Is loaded in, the 
first time the B command is used one byte of the new program will be replaced 
by the stored byte from the last program. 

3. ) Do not set a breakpoint to an address where a breakpoint is already set. Doing so 

will cause the computer to lose the original program data. 

DO NOT THIS IS OK 

B1377 B1377 

G 6 0100 

B1377 B1377 

B carriage return 

4. ) The breakpoint routine uses SWTBUG RAM locations A014-A016; therefore, 

programs which use these three bytes should not be used in conjunction with 
breakpoints. 

DISK BOOT D 

SWTBUG®contains the boot necessary to initialize a SWTPC MF-68 disk system. Typing 
D will transfer control to the disk operating system, (if attached). If D (is accidentally typed 
with no disk attached, the reset button must be pressed. Since the disk boot contains no 
error detection, it may need to be typed more than once to do a boot. - . ^ j r-X 

JUMP TO PROM PROGRAM Z X " ^ 

Typing Z will transfer control to a program stored in PROM (if applicable) whose start¬ 
ing address is at C000. Typing Z is the equivalent of typing J C000. 

BYTE SEARCH F (high address) (low address) (byte) 

The F (find) command will search memory from the specified low address to the high 
address, inclusive, and will display all memory locations containing the byte specified. For 
example, to find all memory locations between 0100 and 0200 that contain BE, the fol¬ 
lowing command should be used:F 020001008E. Note that no spaces may be used between 
addresses and that the high address goes first. 

SF 020001008E 

If a non hex value is entered, SWTBUG control will resume. 
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VECTORED SOFTWARE INTERRUPTS 

Normally when encountering a SWI (3F) instruction, the computer will display the 
processor's registers and SWTBUG®control will be resumed. If desired, the 3F command can 
be vectored to anywhere in memory, just like the NMI and IRO interrupts. To use the vec¬ 
toring capability simply store the service routine address at location A012 - A013 in the 
SWTBUG® RAM. When a 3F is encountered, processor control will be transferred to the 
memory address stored in A012-A013. Note: each time the system is RESET, A012 will be 
reset to the location of the register dump routine. This means that any program which uses 
vectored SWI's should set up this location each time it is executed. If the location you wish 
to vector to is 10D0, for example, the following statements at the beginning of the pro¬ 
gram will set up the vector correctly: 

LDX#$10D0 LOAD VECTOR ADDRESS 
STX $A012 STORE VECTOR 

Vectored software interrupts should not be used in conjunction with breakpoints since 
the breakpoint routine uses locations A012 - A013. 

VECTORED INPUT/OUTPUT 

If desired, input and output can be vectored to a MP-S or MP-C interface on ports 
other than #1. Locations A00A - A0?IB contains the port address that the subroutines INE- 
EE and OUTEEE use for inputting and outputting characters. To use vectored input/output 
your program must store the desired I/O address in A00A -A00B before any I/O is done. Be¬ 
low is a list of I/O address assignments for each port: 

PORT ADDRESS 

0 8000 

1 8004 

2 8008 ^ 

3 800C 

4 8010 

5 8014 

6 8018 

7 801C 

The program statements that would set up the correct port would be as follows: 

^ LDX )S?$8018 I/O on port 6 

STX $A00A Store 

SWTBUG® will look at the port and will self-configure for either a MP-C or MP-S type 
interface. " ' ■ 

NOTE: Any time that SWTBUG*'s control sequeiice is initiated or when the RESET 
button is pushed, the I/O address will be reset to port #1. Therefore complete SWTBUG® 
monitor control cannot be moved to another port. 

USING NON-MASKABLE INTERRUPTS 

Using non-maskable interrupts is very similar to using vectored software interrupts. A 
non-maskable interrupt will occur whenever the NMI line on the computer's bus is ground¬ 
ed either through hardware or by an ACIA or PIA. When the NMI is seen, processor control 
will be transferred to the location stored in A006 and A007. For example if an NMI service 
routine is desired at location 1000 the following statements should be used at the beginning 
of your program to set up the correct NMI jump address. 

LDX #$1000 

STX $A006 

USING MASKABLE (IRQ) INTERRUPTS 

Using regular maskable interrupts is the same as using non-maskable interrupts except 
that when the IRQ line is grounded processor control will jump to the address stored in 
A000 and A001. The computer will only respond to the interrupt if the processor's inter¬ 
rupt mask bit I is 0. A CLI instruction at the beginning of your program will insure this 
condition. . g. 



PIA STROBING 


Use of the Control Interface for Read/Punch—On/Off Decoding 

SWTBUG® software contains subroutines to send out pulses to unused pins of the PIA 
integrated circuit on the MP-C serial control interface that can be used for automatic reader/ 
punch controls. These pulses can be used if you are using a SWTPC AC-30 cassette interface 
and a terminal in which access to the control command decoding is denied. 

If you intend to use the read/punch control logic output on the MP-C control interface 
board, make the following connections from the indicated pins of IC1 on the MP-C control 
interface board to the specified pins of a twelve pin male connector shell. The connector 
pinning shown below is correct for a SWTPC AC-30 cassette interface and will need modifi¬ 
cation for other units. Be sure to make the wires long enough to reach your AC-30 where 
the connector will be plugged. If you have access to your terminal's 16X baud rate clock, 
the terminal's clock bus should be broken and the 16X clock IN and OUT lines brought out 
to the same connector. 


MP-C ICI pin 7 (read on) 
MP-C ICI pin 4 (punch on) 
MP-C ICI pin 6 (read off) 
MP-C ICI pin 5 (punch off) 
Terminal's 16X clock OUT 
Terminal's 16X clock IN 
MP-C ground 


12 pin male shell female pin 1 
12 pin male shell female pin 2 
12 pin male shell female pin 3 
12 pin male shell female pin 4 
12 pin male shell female pin 5 
12 pin male shell female pin 6 
12 pin male shell female pin 12 


These signals are low going pulses and are about 15 microseconds wide. They are not 
buffered and should drive a maximum of only one standard TTL load. 

PIA strobing will work only on SWTBUG®'s L, P and E functions. Strobing is not 
supported in BASIC and some other SWTPC software. 


OPERATING THE MP-A2 PROCESSOR BOARD 
AT BAUD RATES HIGHER THAN 1200 BAUD 
The MP-S Serial Interfaces available for the SWTPC 6800 Computer System are ca¬ 
pable of operating at baud rates up to 9600 baud. Although baud rate clocks for 110, 150, 
300, 600 and 1200 baud are generated, buffered and fed onto the mother board byJC4 of 
the MP-A2 board, clocks for additional baud rates are also available from IC4 as well. The 
table below gives the baud rate and respective output pin number of IC4. 

BAUD RATE MP-A2 IC4 pin 


75 

9 

200 

6 

1800 

15 

2400 

3 

3600 

16 

4800 

2 

7200 

17 

9600 

1 


To use the selected clock, run an insulated jumper between the specified pin and pin 
13 of IC10 on the MP-*A2 board. Run another insulated jumper between pin 12 of IC10 and 
either the UD1 of UD2 bus connections points at the connector edge of the MP-A2 circuit 
board. IC10 is a low power TTL buffer which must be inserted between the baud rate clock 
generator and the mother board bus. Sinc^ user defined lines UD1 and UD2 are carried on 
just the 50-pin main board bus and lines UD3 and UD4 are carried on just the 30-pin inter¬ 
face board, it will be necessary to jumper two pf ^e buses together to provide the selected 
baud rate clock on the interface card bus. Each sefial interface card to be operated with the 
selected buad rate clock will have to be jumpered so its clock is acquired from the selected 
user defined line rather than one of the five original baud rate clocks already present. 


- 10- 



OPERATING THE MP-A PROCESSOR BOARD 
AT BAUD RATES HIGHER THAN 1200 BAUD 

When using the MP-S serial interface with an MP-A processor board, baud rate clocks 
for up to 9600 baud are available from the baud rate generator on the MP-A processor 
board. The table below shows the baud rates available and from which pin of IC4 on the 
MP-A board they are derived. These 16X baud rate clocks are best fed back to the interface 
boards via the user defined lines provided on the mother board. These baud rates of course 
are in addition to the 110,150,300,600 and 1200 baud rate clocks already provided on the 
motherboard. 

BAUD RATE MP-A ICA Pin 


75 

9 

200 

6 

1800 

15 

2400 

3 

3600 

16 

4800 

2 

7200 

17 

9600 

1 


COMPATIBILITY 


Although SWTBUG has been written to be as compatible as possible with MIKBUG® 
and with software supplied by SWTPC, it can never be completely MIKBUG® compatible. 
All major subroutines of SWTBUG®are address and function compatible with MIKBUG®, 
but if you have a program that enters into the middle of a MIKBUG®routine for some rea¬ 
son, program modifications will be necessary. The following is a list of the MIKBUG®com- 
patible subroutines and strings along with their entry point addresses. 


Ep40 

£047 

E055 

E075 

E078 

E07B 

E07E 

E0BF 


LOAD 19 

BADDR 

BYTE 

OUTCH 

INCH 

PDATA2 

PDATAl 

OUT2H 


E0C8 

E0CA 

E0D0 

E0E3 

E19C 

E19D 

ElAC 

E1D1 


OUT4HS 

OUT2HS 

START 

CONTRL 

MCLOFF 

MCL 

INEEE 

OUTEEE 


If any doubt exists as to the compatibility of a pakicular program, it should be disas¬ 
sembled and any references to memory locations E000 -El FF be verified. 

Since SWTBUG®is more complex than MIKBUG®, more RAM area must be used in the 
6810 SWTBUG® RAM. If vectored software interrupts and breakpoints are not being used, 
the area from A014 to A033 and from A04A to A07F can be used for small, temporary pro¬ 
grams such as memory diagnostics. Note that some programs written for MIKBUG® use 
locations A034 - A036—these locations are not available for use in SWTBUG® 


^ LOADING BINARY TAPES THRU SWTBUG® 

SWTBUG was written to accept the binary formatted tapes supplied by SWTPC These 
tapes include 4K BASIC, 8K BASIC, CORES and DESEMBLER. When loading these tapes 
the following rules must be followed: 

1. ) The tape reading device (AC-30, etc.) must be locked in the read on mode during 

the binary load. 

2. ) Binary tapes must be loaded in thru port the control port. The optional load 

from port 0 command is not supported in binary. You may load in ASCII however. 

3. ) When using a PIA type interface to load binary tapes, the unused lines used for 

reader/punch on/off strobing are not activated. 





NOTE: This does not mean that SWTBUG*is equipped with a binary loader—only cer¬ 
tain SWTPC binary tapes that contain a special binary loader (in ASCII) will work correctly. 

To load the tape simply follow the instructions given for loading an ASCII tape, but 
keep the reader locked on. 


SPECIAL NOTES ON USING AN ACIA AND PROGRAM MODIFICATIONS 
Many available 6800 programs written for MIKBUG® assume that a PI A' type MP-C 
control interface is being used and may address this port directly. When using an ACIA type 
interface, these references need to be changed. For example, some programs, such as BASIC 


and CO-RES, poll the PIA periodically to see if a character has been typed in. This is done 
in order to kick out of a loop or a print sequence. (BASIC uses CTL.C and CO RES uses 


CTL.X.) The source statements that do this usually take the following form: 

B6 8004 LDA A PIAD LOAD A FROM DATA REG. 

2B03 BMI PRINT BRANCH IF NOT CHAR. SEEN 

7EXXXX JMP READY or RESTART 

PRINT REMAINDER OF SEQUENCE 


To change to a MP-S serial interface, this code can sometimes be replaced as follows; 


LDA A PIAD- 
BMI PRINT 


- > ASR A SEE IF CHAR. LOADED 

-> BCSPRINT BRANCH IF CHAR. INPUT 

JMP READY 

PRINT REMAINDER OF SEQUENCE 


Before modifying any programs on your own, you should have a working knowledge of 
SWTBUG®'s ACIA input routine, ACIA operation, and your particular program. The follow¬ 
ing is a list of patches to some SWTPC supplied programs. 



I 


BLKJAK - SWTPC 6800 Black Jack Program 

DATA 
7E 064A 
7E 026D 
B6 E008 
27 08 
B6 8004 

2B F3 ' 

7E0275 ■: 

B6 8004-^'■ 

47 

24EA 
20 F5 

With the above modifications BLKJAK will be compatible with either an ACIA or PIA 
type interface. 

CO-RES Ver. 1.0 and 1.01 ACIA Modifications 

LQCATION DATA 

1682 47 

1683 24 02 

1685 20 A0 

BASIC 8K and 4K up to an including Ver. 2.0 cannot be modified for ACIA operation. 
Later versions should be purchased. 



LQCATION 

0270 

0647 

064A 

064D 

064F . 

0652 - 

.: . - 0654 . 

0657 
065A 
065B 
065D 
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GENERAL RULES FOR PROGRAM WRITING 


Although for a user program to be functional it need only work with the exact system 
it was written for, following a few simple rules reduces program modifications for 6800 sys¬ 
tems using other monitors. Following these rules will make your programs more profes¬ 
sional and versatile. Some general guidelines are as follows: 

1. ) Minimize the number of references made to the ROM. 

2. ) Do not use strange, in-between SWTBUG® addresses. Generally only the routines 

BADDR, BYTE, PDATAl, INHEX, OUT4HS, OUT2HS, CONTRL, INEEE and 

OUTEEE should be used. 

3. ) For large programs, vector I/O through a jump instruction for ease of change to 

match other I/O packages. Example: 


DON'T 
JSR INEEE 


JSR INEEE 


JSR INEEE 


DO 

JSR^INPUl 
JSR INPUT. 

I 

JSR INPUT' 


INPUT: JMP INEEE 


4.) Try not to use the SWTBUG® RAM any more than necessary. With the exception 
of using it as stack storage and memory diagnostics, there is no real reason to use 
the SWTBUG® RAM area. 


5. ) Define the stack area at the beginning of the program. Example: Start LDS 

A042. Relocating the stack location to A|D42 at the beginning of each of your 
programs will prevent you from having to reload the program counter addresses 
A048 and A049 each time you RESET and restart your program. 

6. ) Most programs should have a provision for exiting them without hitting the RE¬ 

SET button. A jump to CONTRL (7E E0E3) instruction in your program will 
cause SWT BUG* control to resume when executed. 


MEMORY DIAGNOSTICS 

The earlier memory diagnostics ROB IT, MEMCON and CDAT supplied by SWTPC were 
compatible only with MIKBUG®. The new versions ROBIT 2, MEMCON 3 and CDAT 2 are 
compatible with both MIKBUG®and SWTBUG®. 


PROGRAM DESCRIPTION 

Although the source listing of SWTBUG®is well commented, the following subrou¬ 
tine by subroutine description should be of use to those who wish to gain the maximum ad¬ 
vantage of its routines. 

TEMPORARY STORAGE LOCATIONS 

IRQ (AOOO) This location is used by the standard IRQ interrupt request feature. When 
an interrupt is generated, processor control will jump to the location stored 
in IRQ. 

BEGA (A002) This location is where the beginning address is stored for the punch and end 
of tape routines. 

ENDA {A004) This location is where the ending address is stored for the punch and end 
of tape routines. It is also used by the byte search routine. 

NMI (A006) NMI is used by the non-maskable interrupt (NMI) function. When an NMI 
is generated, processor control will jump to the location stored in NMI. 
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SP (A008) 

PORADD (A00A) 
PORECH (A0OC) 
XHI {A0(DD) 
XLOW (AO0E) 
XTEMP (A010) 
SWIJ.VIP IA012) 

BKPT {A014) 
BKLST(A016) 
TW (A044) 

TEMP (A046) 
BYTECT (A047) 

S 

IRQV (E000) 

JUMP (E005) 

CURSOR (E009) 
LOAD (EPOC) 

BADDR (E047) 


Temporary storage location for the stack pointer. SP is used in the register 
dump subroutines and by the breakpoint function. 

This location contains the port address used for SWTBUG 's I/O routines. 

This byte tells SWTBUG 's input routines whether or not to echo. 

Temporary index register storage used by numerous routines. 

Temporary index register storage used by numerous routines. 

Temporary index register storage for input and output routines. 

When a SWI instruction is encountered, processor control will transfer to the 
location stored in SWIJMP. 

Temporary breakpoint address storage. 

Temporary data storage for the breakpoint routine. 

Temporary storage location for load/punch. 

Temporary storage location for punch and load. 

Temporary storage location for load/punch. 

VTBUG®SUBROUTINE AND TEXT STRING DESCRIPTION 


This is the entry point for regular IRQ interrupts. Processor control is given to 
the service routine whose address is stored in IRQ. 

This is the service routine for the J command. BADDR is used to input the 
address and a jump then occurs to the correct address. 

Home-up and erase to end of frame characters for CT 1024. 

Load is the ASCII loading routine. Load uses a number of other SWTBUG* 
subroutines. 

BADDR is a subroutine to input a 4-digit hexadecimal number, such as 137D, 
from the control terminal. BADDR uses the subroutines BYTE, INCH and IN¬ 
HEX and uses temporary storage locations XHI, XLQW, CKSM, both accumu¬ 
lators and the index register. When BADDR is called it will look for four hex 
numbers to be entered from the terminal. If a non-hex value, such as H, is en¬ 
tered, SWTBUG control will resume. If all characters entered are valid hex, 
the results will be stored in XHI, XLQW and the index register. Accumulator 
A will contain of XLQW. If 137D is entered the results will be as follows- 


ACC A 

7D 

ACC B 

CKSM 

IXR 

137 D 

XHI 

13 

XLQW 

7D 


CKSM and ACC B are used internally to generate a check sum for the PUNCH 
routine. 
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BYTE (E055) BYTE is similar to BADDR, but inputs only two hex characters from the ter¬ 
minal to generate one 8-bit byte equivalent. BYTE uses the subroutines INHEX 
and INCH, temporary storage locations CKSM and both accumulators. If a non¬ 
hex value is entered, SWTBUG® control will resume. When BYTE is called as a 
subroutine, the computer will wait for two hex characters to be entered thru 
the control port. If a 3C is entered, the results will be as follows: 

ACC A 3C 

ACC B CKSM 

IXR UNCHANGED 

CKSM Prior CKSM + check sum generated inside 

BYTE 

OUTHL(E067) These subroutines are used by OUT2HS and OUT4HS to output hexadeci- 
OUTHR (E06B) mal numbers. 

OUTEEE, This is the character output routine used by PDATA1, OUT4HS, OUT2HS and 

OUTCH most programs written for SWTBUG®/MIKBUG®to output one character from 

OUTEE1 the computer to the control port (I/O OUTEEE, OUTCH and OUTEE1 

(E1D1) are all functional equivalents—OUTEE1 is the main output routine with OUT¬ 

CH and OUTEEE being jumps to OUTEE1. When using this routine, OUTEEE 
(E1D1) sould be used to maintain compatibility with MIKBUG®systems. 

To use OUTEEE the character to be output should be placed in the A 
accumulator in its ASCII form. To output the letter A on the control terminal, 
the following program could be used. 

LDA A# $41 

JSR OUTEEE 

The processor's registers are affected as follows. 

ACC A changed internally 

ACC B not affected 

IXR not affected 

OUTEEE is an 8-bit output routine and does not generate a parity bit. 

INEEE, The locations are all functionally equivalent to SWTBUG 's character input 

INCH, routine. This routine will look for one character from the control terminal (I/O 

INEEE 1 #1) and store it in the A accumulator. Once called, INEEE will loop within it- 

(E1AC) self until a character has been input. Anytime input is desire, the call JSR IN¬ 
EEE should be used. . ^ ■ ii;. . ■ -i. 

INEEE automatically sets the 8th bit to 0 and does not check for parity. 
When using INEEE the processor's registers are affected as follows: 

ACC A loaded with the character input from the 

terminal 

ACC B not affected 

IXR not affected 


INCH8 (E1F6) 


INHEX (E0AA) 


INCH8 is functionally the same as INEEE except that the 8th bit is not set to 
0. This subroutine should be used whenever full 8-bit input is desired, such as 
in binary loader programs. 

INHEX is the subroutine used by BYTE and BADDR that will input one hexa¬ 
decimal character from the control terminal. If a non-hex character is entered, 
SWTBUG® control will resume. If a hex character, such as an E is entered, the 
results will be as follows: 

ACC A 0E 

ACC B not affected 

IXR not affected 

- 15- 







PDATA1 (E(j7E) PDATAl is the subroutine used to output a string of text on the control ter¬ 
minal. PDATA1 will start outputting data that is pointed to by the index re¬ 
gister and will continue until a 04 is seen. For example, if you wanted to print 
HELLO on the terminal the following could be used. 

ORG $100 

START LDX # TEXT 
JSR PDATAl 
JMP CONTRL 
TEXT FCB $0D, $0A 
FCC /HELLO/ 

FCB 4 
END 

The accumulator and register status after using PDATAl is as follows: 

ACC A Changed during the operation 

ACC B UNCHANGED 

IXR Contains the memory location of the 04 

CHANGE {E088) CHANGE is SWTBUG®'s memory examine and change function. Change uses 
a number of other SWTBUG®subroutines. 

OUT4HS (E0C8) OUT4HS is used to output a four-digit (16-bit) hexadecimal number onto the 
control terminal. The address of the most significant byte to be output should 
be loaded into the index register before calling OUT4HS. For example, to out¬ 
put the 16-bit hex number stored in memory locations 1000 and 1001 whose 
most significant byte is in 1000 while the least significant byte is in 1001 the 
following sequence should be used: 

LDX # $1000 
JSR OUT4HS 

If location 1000 contained a hex 3C and 1001 contained a hex 0B, an 
ASCII, 3C0B would be displayed on the screen when OUT4HS is called. Re¬ 
member memory data is handled in hex but must be output as ASCII charact¬ 
ers which have a different hex value than those stored in the computer's 
memory. The registers are affected as follows: 

ACC A changed during the operation 

ACC B unchanged 

* IXR '^'^' Incremented by two. * : < 

(1002 in this example) 

OUT2HS (E0CA) OUT2HS is similar to OUT4HS, but outputs only two hex characters (one 
byte). For example, to display the byte stored at 2000 the following sequence 
would be used: 

LDX #$2000 

JSR OUT2HS 

An ASCII 6C would be output to the control terminal if location 2000 
contained a hex 6C. The registers are affected as follows: 

ACC A changed in the operation 

ACC B unchanged 

IXR Incremented by one (2001 in this example) 

OUTS (E0CC) OUTS is a subroutine that outputs one space to the control terminal. 

START (E0D0) START is the beginning of a sequence of steps that initialize the system during 
power up or reset. First, the stack pointer is set to be A042 and is stored in SP. 
Next, an FF is stored in location A043. This sets the interrupt mask bit in the 
stack so that when a G command is given the processor will not respond to 

- 16 - 




interrupts until told to do so. The type of port being used (ACIA or PIA) is 
then determined by initializing it as a PIA and looking to see if this worked. If 
not, an ACIA is assumed and the proper ACIA initialization routine, AL2, is 
selected. The program then goes to CONTRL sequence. 

CONTRL (E0E3) This MIKBUG*equivalent sequence again resets the stack to A042. PORECH is 



cleared to enable echo and the subroutine SAVGET is selected to get the cor¬ 
rect port number and type. Next, the routines PNCHOF and RDOFF generate 
punch and reader off commands. A carriage return, line feed, erase to end of 
line (15 i 6) and a $ is then output to the control terminal. At this point SWT- 
BUG®is ready for command input. 

SFE1 (E124) 

SFE1 is the entry point for non user-vectored software interrupt instructions. 
If vectored software interrupts are selected, a jump is executed to the proper 
location. If breakpoints are in use the stack pointer is not changed, the pro¬ 
cessor's registers are displayed and SWTBUG®is instructed to look for the next 
command. If neither breakpoints or vectored software interrupts are selected 
a register dump occurs and the CONTRL sequence is initiated. 

PRINT (E130) 

PRINT is the routine that actually does the dumping of the processor's regis¬ 
ters. 

LOOK (El73) 

LOOK is the routine that inputs a character from the terminal and jumps to 
the appropriate location in SWTBUG®if it is a valid command. 

SFE (E18B) 

Entry point for software interrupt instructions. 

S9(E190) 

S and 9 string for the end of tape routine. 


MTAPE1 (E193) This is the character string containing a carriage return, line feed, erase to end 


MCL (E19D) 

of line, four nulls, a SI for tape control and 04 for PDATA1 control. 

This string contains a carriage return, line feed, three nulls, a $ and a 04 for 
PDATAl control. , 

E1A5 (E1A5) 

E1A5 Is a special entry location which is used by the binary load routine on 
some SWTPC binary tapes. ; 

NMIV (E1A7) 

This routine fetches the correct jump location for a NMI. 


SEARCH {El AE)Byte searching routine. 

GOTO (E1D0) GOTO contains the RTI instruction that is used by the G command to execute 
a user program. 

SAVGET (E1D3)This routine saves the index register in XTEMP and tests for the appropriate 
interface location and type. The index register is then loaded with the address 
of this interface. 

ISACIA (E1D9) ISACIA is the routine that sees if an ACIA or PIA is present. 

BILD (E1F3) BILD is a special sequence of increment stack pointer instructions used only 
by the binary loader on some SWTPC binary tapes. 

ACIAIN (EIFF) This is the ACIA input routine. PORECH is polled for the desired echo/don't 
condition. The character in the A accumulator is then output, the index regis- 
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ter and B accumulator restored and an RTS instruction executed by the RES 
routine. 

ACIOUT (E212) This is the ACIA output routine which outputs the character in the A accumu¬ 
lator, and recovers the B accumulator and index register. 

INI (E223) INI is the PIA input routine which inputs a character from the control terminal 
and stores it in the A accumulator. The correct echo/non echo condition is 
selected and the B accumulator and index register are restored. 

lOUT (E240) lOUT is the PIA output routine which outputs the character in the A accumu¬ 
lator. 

OPTL (E269) OPTL is the service routine that sets up PORECH for I/O on port 0. The ap¬ 
propriate command P, E or L is then selected. 


PIAECH (E27D) This routine disables the echo on a PIA type interface. 

PIAINI (E284) This routine is used to Initialize PIA type interfaces. 

DELAY (E202) DELAY is a general purpose delay loop. If desired, the index register can be 
pre-loaded with a number other than FFFF for shorter delays. The entry point 
In this case is DELAY1 (E2C5). 

CLEAR (E2CC) This routine generates a home up, erase to end of frame command for SWTPC 
CT 1024 and similar terminal systems. 


BREAK {E2D9) BREAK is the routine that is used to enter software breakpoints. First, the ad¬ 
dress is input by BADDR. If breakpoints were previously in use the data is 
replaced at the previous breakpoint address and the new breakpoint is inserted. 


PNCHS9 {E31E) This routine selects A048 and A049 as the beginning and ending address for the 
punch routine and punches their contents. A S9 is then punched to tape fol¬ 
lowed by a short delay. 


RDON (E334) These subroutines are used to turn a reader/punch on and off. At the beginning 
RDOFF (E347) of each routine the A accumulator is loaded with the ASCII value of the par- 
PNCHON (E34D)ticular function that is normally decoded by a Teletype®or other terminal sys- 
PNCHOF (E353) tern. The B accumulator is then loaded with a special bit pattern that will cause 
a predetermined line to be toggled on PIA type interfaces. ACC A is then out¬ 
put using OUTEEE and if a PIA type interface is being used the proper PIA line 
is strobed by the STROBE routine. The proper line is determined by the con¬ 
tents of ACC B. The subroutine RDON also clears the location PORECH and 
re-configures PIA type interfaces to be sure that the echo function of the 
character input routine is disabled. Both accumulators and the index register 
are used and are not retained. 


ACC A 

ACC B 

FUNCTION 

11 

20 

Reader ON 

13 

10 

Reader OFF 

12 

04 

Punch ON 

14 

08 

Punch OFF 


STROBE (E357) This is the routine that actually generates the pulses on the un-used lines of a 
PIA type interface for reader/punch control. 

PUNCH (E376) PUNCH is the ASCII punching routine of SWTBUG?PUNCH consists of several 
parts and uses various SWTBUG®subroutines. 

TABLE (E3D1) This is the command table used by the lookup routine. The table is arranged in 
three byte blocks. The first byte is the ASCII value of the command. The next 
two bytes are the address of the routine that will service the command. 


SWTBUG is a registered trademark of Southwest Technical Products Corp. 
MIKBUG is a registered trademark of Motorola Inc. 

Teletype is a registered trademark of Teletype Corp. - 18 - 
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